Get-GSCalendarSubscription

SYNOPSIS

Gets a subscribed calendar from a users calendar list. Returns the full calendar list if no CalendarId is specified.

SYNTAX

List (Default)

Get-GSCalendarSubscription [-User <String[]>] [-MinAccessRole <MinAccessRoleEnum>] [-PageSize <Int32>]
 [-Limit <Int32>] [-ShowDeleted] [-ShowHidden] [-SyncToken <String>] [<CommonParameters>]

Get

Get-GSCalendarSubscription [-CalendarId] <String[]> [-User <String[]>] [<CommonParameters>]

DESCRIPTION

Gets a subscribed calendar from a users calendar list. Returns the full calendar list if no CalendarId is specified.

EXAMPLES

EXAMPLE 1

Get-GSCalendarSubscription

Gets the AdminEmail user's calendar list

PARAMETERS

-CalendarId

The calendar ID of the calendar you would like to get info for. If left blank, returns the list of calendars the user is subscribed to.

Type: String[]
Parameter Sets: Get
Aliases: Id

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Limit

The maximum amount of results you want returned. Exclude or set to 0 to return all results

Type: Int32
Parameter Sets: List
Aliases: First

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-MinAccessRole

The minimum access role for the user in the returned entries. Optional. The default is no restriction.

Type: MinAccessRoleEnum
Parameter Sets: List
Aliases:
Accepted values: FreeBusyReader, Owner, Reader, Writer

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PageSize

Maximum number of entries returned on one result page. The page size can never be larger than 250 entries.

Type: Int32
Parameter Sets: List
Aliases: MaxResults

Required: False
Position: Named
Default value: 250
Accept pipeline input: False
Accept wildcard characters: False

-ShowDeleted

Whether to include deleted calendar list entries in the result. Optional. The default is False.

Type: SwitchParameter
Parameter Sets: List
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ShowHidden

Whether to show hidden entries. Optional. The default is False.

Type: SwitchParameter
Parameter Sets: List
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SyncToken

Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then.

If only read-only fields such as calendar properties or ACLs have changed, the entry won't be returned. All entries deleted and hidden since the previous list request will always be in the result set and it is not allowed to set showDeleted neither showHidden to False.

To ensure client state consistency minAccessRole query parameter cannot be specified together with nextSyncToken. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken. Learn more about incremental synchronization.

Optional. The default is to return all entries.

Type: String
Parameter Sets: List
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-User

The primary email or UserID of the user. You can exclude the '@domain.com' to insert the Domain in the config or use the special 'me' to indicate the AdminEmail in the config.

Defaults to the AdminEmail in the config

Type: String[]
Parameter Sets: (All)
Aliases: PrimaryEmail, UserKey, Mail

Required: False
Position: Named
Default value: $Script:PSGSuite.AdminEmail
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

Google.Apis.Calendar.v3.Data.CalendarListEntry

NOTES

https://psgsuite.io/Function%20Help/Calendar/Get-GSCalendarSubscription/

https://developers.google.com/calendar/v3/reference/calendarList/get

https://developers.google.com/calendar/v3/reference/calendarList/list

Comments